home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / basic / fossc004.zip / FOSSCOMM.TXT < prev    next >
Text File  |  1988-10-31  |  31KB  |  1,292 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                        
  7.                                        
  8.                                        
  9.                                        
  10.                                        
  11.                                        
  12.                                        
  13.                                        
  14.                                        
  15.                                        
  16.                                        
  17.                                        
  18.                                        
  19.                                        
  20.                    FossComm
  21.                                        
  22.                                  version 0.04
  23.                                        
  24.                                        
  25.                                 August 22, 1988
  26.                                        
  27.                                        
  28.                              Program Documentation
  29.                                        
  30.                                        
  31.                                        
  32.                                        
  33.                                        
  34.                     Copyright (C) 1988  Daan van der Weide
  35.                               All rights reserved
  36.                                        
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.          
  79.  
  80.            FosComm is an  interface between a  compiled BASIC  program
  81.          and a so-called FOSSIL  driver. It enables  the user to  take
  82.          advantage of all  the functions  regarding the  communication
  83.          ports, from a BASIC  program. In this way  it is possible  to
  84.          avoid the problems/shortcomings  of the BASIC  communications
  85.          handler.
  86.  
  87.            FossComm is based on  the document 'Fundamentals of  FOSSIL
  88.          implementation and use, draft  version 5, February 11,  1988'
  89.          by Rick Moor. Please make sure that your fossil driver  meets
  90.          this draft.
  91.  
  92.  
  93.            FossComm can be used with any of the following compilers :
  94.  
  95.                 MicroSoft Quickbasic 1.00, 2.00, 3.00 and 4.00, 6.00
  96.                 IBM BasCom           1.00, 2.00
  97.  
  98.  
  99.          LICENSE AND REGISTRATION
  100.          ------------------------
  101.  
  102.            FossComm is distributed  as a  'shareware' program.  Please
  103.          help me get it known by giving away unmodified copies of  the
  104.          program and documentation to other people, either by  copying
  105.          the disk  or making  it available  for downloading  on a  BBS
  106.          system.
  107.  
  108.            FossComm is copyright (C) 1988 by Daan van der Weide. It is
  109.          not public domain or free software. Non-registered users  are
  110.          granted a limited license  to use FossComm  on a trial  basis
  111.          for determining  whether  or not  it  is suitable  for  their
  112.          needs. Registration allows  the use of  FossComm in  programs
  113.          for sale and/or distribution.
  114.  
  115.            The registration fee is 50 guilders (25 US$). Users who pay
  116.          the registration  fee will  be sent  a disk  woth the  latest
  117.          version and documentation ans some example programs.
  118.  
  119.            It  is  also  possible  to  obtain  the  source  codes  for
  120.          FossComm. In that case the  registration fee is 100  guilders
  121.          (50 US$).
  122.  
  123.            Register your usage of FossComm by sending the registration
  124.          fee to :
  125.  
  126.                         Daan van der Weide
  127.                         Kastelenstraat 229-3
  128.                         1082 EG  Amsterdam
  129.                         the Netherlands
  130.  
  131.                         telephone : (0)20 463647
  132.  
  133.            Your  comments  regarding  the  FossComm  program  or   any
  134.          suggestions you  have for  extensions or  for other  programs
  135.          that would be useful to you are welcome.
  136.  
  137.          ------------------------------------------------------------
  138.          FossComm                   page 2                    FossComm
  139.          
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.            Daan van der Weide makes no warranties whatsoever regarding
  151.          the FossComm computer program or the documentation.
  152.  
  153.  
  154.          USING FOSSCOMM IN YOUR PROGRAMS
  155.          -------------------------------
  156.  
  157.            The FossComm  module contains  a number  of functions  that
  158.          handle the access of  RS232 communication boards as  provided
  159.          by a driver conform the FOSSIL standard.
  160.  
  161.            Below follows a  list of  the functions  supported and  the
  162.          parameters that should be specified, as well as the  eventual
  163.          return values. To incorporate the module within your compiled
  164.          program specify  the  name  FOSSCOMM.OBJ  when  linking  your
  165.          program. Example :
  166.  
  167.            LINK MYPROG+FOSSCOMM,MYPROG;
  168.  
  169.  
  170.          CREDITS
  171.          -------
  172.  
  173.            I would like to mention a few people who have supported and
  174.          still are supporting the development :
  175.  
  176.            Ronald Koridon who adapted RBBS 16.1a to run using FossComm
  177.          and who is my primary 'guinea-pig'; Arjen Lentz, John Janssen
  178.          sysops that are using the RBBS 16.1a FOSSIL version as  well.
  179.          the RBBS version as well  to run. (they've probably  upgraded
  180.          by now ...)
  181.  
  182.  
  183.          FEEDBACK
  184.          --------
  185.  
  186.            As you  may know,  any software  developer depends  on  his
  187.          users to  modify, adjust  and extend  his product.  Therefore
  188.          I'm very  interested  in  all  comments,  notes  and  critics
  189.          towards the  FossComm product.  I can  be reached  either  by
  190.          telephone or, better, at the RBBS system listed below.  Thank
  191.          you very much !
  192.  
  193.                               RBBS Gaasperdam (4 lines)
  194.                               sysop Ronald Koridon
  195.                               Amsterdam, the Netherlands
  196.  
  197.                               31  (0)20 978493  node 1
  198.                                         913890  node 2
  199.                                         974420  node 3
  200.                                         972763  node 4
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.          ------------------------------------------------------------
  210.          FossComm                   page 3                    FossComm
  211.          
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.          
  223.          Revision                                              history
  224.          ----------------
  225.  
  226.          v0.01
  227.  
  228.                 This is the first alpha-test version only released  to
  229.          people involved in testing.
  230.  
  231.  
  232.          v0.02
  233.  
  234.                 Extended FOSSIL calls  implemented to access  keyboard
  235.          and to do video I/O etc. Not released.
  236.  
  237.  
  238.          v0.03
  239.  
  240.                 Adaptions according  to  draft 5  are  made.  FOSSPEED
  241.          changed, so that parity, databits and the number of  stopbits
  242.          may be specified as well. The documentation is extended,  and
  243.          a number of functions was added.
  244.  
  245.          v0.04
  246.  
  247.                 I think  the product  is solid  enough to  release  it
  248.          generally, especially because there's 'official' RBBS support
  249.          for FossComm. A number of BBS  systems are running for a  few
  250.          months now without any problems.
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.          ------------------------------------------------------------
  282.          FossComm                   page 4                    FossComm
  283.          
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.          
  295.          -------------------------------------------------------------
  296.          FOSINIT
  297.          -------------------------------------------------------------
  298.  
  299.          PURPOSE :
  300.  
  301.            Initializes the  FOSSIL  driver,  and  checks  whether  the
  302.          FOSSIL driver is  installed. This function  should be  called
  303.          before any other FOS  calls are made. DTR  is raised by  this
  304.          call. The baudrate is NOT set by this call.
  305.  
  306.  
  307.          FORMAT  :
  308.  
  309.            FOSINIT(port%, result%)
  310.  
  311.  
  312.          RETURNS :
  313.  
  314.            0    no error, driver initialized
  315.           -1    error initializing driver
  316.  
  317.  
  318.          EXAMPLE :
  319.